home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 2 / Atari Mega Archive CD - Volume 2.iso / mint / x11 / docs / install.x11 < prev    next >
Text File  |  1995-04-22  |  6KB  |  219 lines
  1. An X-Window system Port for MiNT
  2.  
  3.  
  4. This is a port of the X-Window system (X11R5) for MiNT. Unfortunately,
  5. this
  6. distribution contains only executables. There's still a lot of work to be
  7. done
  8. to be able to distribute the full source code. Until shortly you could get
  9. the
  10. original source code on ftp-server of the TU Darmstadt, but somehow they
  11. are
  12. gone now. (This might have something to do with the fact that they have
  13. X11R6
  14. there now?!) Anyway, you can find more fonts and documentation there.
  15.  
  16.  
  17. Installation
  18. ============
  19.  
  20. 1. Install mint-net and get a shell "sh".
  21.  
  22. 2. Create a neu directory. In the following steps you must replace "$X11"
  23. with
  24.    this directory.
  25.  
  26. 3. Unpack the archive in "$X11". You will get the directories "$X11/etc",
  27.    $X11/home and $X11/usr.
  28.  
  29. 4. Create the directory "$X11/tmp".
  30.  
  31. 5. Create the directory "$X11/bin" and put the shell "sh" in it.
  32.  
  33. 6. Edit (or create) the file "mint.cnf": It should contain at least:
  34.    CON=u:\dev\console
  35.    PRN=u:\dev\console
  36.    cd u:\
  37.    setenv UNIXMODE /-ru
  38.    setenv PATH /usr/local/bin/X11
  39.    setenv HOME $X11/home
  40.    sln $X11\bin u:\bin
  41.    sln $X11\etc u:\etc
  42.    sln $X11\usr u:\usr
  43.    sln $X11\tmp u:\tmp
  44.    exec $X11\bin\kbd
  45.    exec $X11\pty\pty
  46.    INIT=$X11\usr\local\bin\X11\xinit
  47.  
  48. 7. Restart your computer. You should get a "xterm" and a "xclock".
  49.  
  50. The X-Server
  51. ============
  52.  
  53. The actual X-server is called "X". It should be invoked by "xinit" or
  54. "startx"
  55. but can also be invoked directly. If you invoke the server directly, the
  56. "DISPLAY" environment variable should be set to ":0".
  57.  
  58. The "/tmp" directory has to be on a minix-partition of your disk or you
  59. have to
  60. invoke the server as "root". Otherwise you'll get an error like this:
  61.  
  62.     Binding Unix socket: access denied.
  63.  
  64. When the X-server starts, the program will print out an error message like
  65.  
  66.     Couldn't open RGB_DB '/usr/lib/X11/rgb'
  67.  
  68. You can safely ignore it. Sometimes you will also encounter a message like
  69.  
  70.     Unix domain socket /tmp/.X11-unix/X0 trashed, receating
  71.  
  72. This is because this file is supposed to be a socket and not a normal
  73. file. But
  74. this shouldn't cause any other problems.
  75.  
  76. The server needs at least two fonts: "cursor" and "fixed". They can be
  77. found in
  78. the "fonts" subdirectory. If you want to install more fonts, put them
  79. there
  80. too.
  81.  
  82. The keyboard driver is called "kbd". Kbd installs a driver that puts the
  83. scancodes in "/dev/scancode". You have to be "root" to do this. The only
  84. option
  85. is "-n". This option causes the driver to pass on keyboard events to TOS,
  86. even
  87. when another program gets them (i.e. when "/dev/scancode" is open).
  88.  
  89. You can kill the server with "CTRL-LSHIFT-ESC" immediately. However,
  90. running
  91. applications aren't shutdown correctly (yet?).
  92.  
  93. The server doesn't use VDI. It accesses the display memory directly. Up to
  94. now
  95. it only supports monochrome displays. You can only run TOS and X programs
  96. with
  97. this server. You _cannot_ run GEM files!
  98.  
  99. The two mouse buttons on the Atari mouse play the roles of the first and
  100. third
  101. mouse button on a normal X-mouse. You will probably be able to use the
  102. second
  103. mouse button on three-button-mice that use "/dev/mouse" correctly.
  104.  
  105.  
  106. Applications
  107. ============
  108.  
  109. You can set global application defaults in "/usr/lib/X11/app-defaults/*"
  110. and
  111. personal user defaults in "~/.Xdefaults". The author's personal defaults
  112. file
  113. is incuded as "home/.Xdefaults" in the distribution. The files in the
  114. "usr/lib/X11/app-defaults" directory are the original system defaults.
  115.  
  116.  
  117. xterm
  118. -----
  119.  
  120. You need the "pty" driver to run xterm. With every invokation you will get
  121. two
  122. ptys in "/dev/[pt]tty*". This can only be done as root. However, this
  123. driver
  124. doesn't work reliably: the stty settings don't work.
  125.  
  126. Also, you'll need the "/etc/termcap" file. The original "termcap" file is
  127. included in the distribution.
  128.  
  129. On the author's machine the "tcsh" shell crashed a couple of times
  130. (shortly
  131. before the prompt came up). This was fixed by shortening the entry for
  132. "xterm"
  133. in "/etc/termcap". But lately, it seems to work even without
  134. modifications.
  135.  
  136. There's a utility program called "resize" that re-sets the values of
  137. "COLUMNS"
  138. and "LINES" when you have changed the size of your window.
  139.  
  140.  
  141. twm
  142. ---
  143.  
  144. The "twm" configuration is determined by the contents of
  145.  
  146.     /usr/lib/X11/twm/system.twmrc
  147.  
  148. and also "~/.twmrc". The first should contain global definitions and the
  149. second
  150. personal definitions that are preferred.
  151.  
  152. The files "{jim,keith,lemke}.twmrc" are the original twm files.
  153. "home/.twmrc"
  154. is the authors configuration.
  155.  
  156.  
  157. xinit
  158. -----
  159.  
  160. This program sets up the X-server and then tries to call "~/.xinitrc" or
  161. "/usr/lib/X11/xinit/xinitrc". If this fails you will get an "xterm".
  162. "home/.xinitrc.orig" is the original file, "home/.xinitrc" is the file
  163. that the
  164. author uses.
  165.  
  166. There's also a shell script "startx" that calls "xinit".
  167.  
  168.  
  169. bitmap, atobm, bmtoa
  170. --------------------
  171.  
  172. This program needs the "Bitmap" resource file and the corresponding
  173. bitmaps to
  174. work.
  175.  
  176.  
  177. x11perf
  178. -------
  179.  
  180. The window of this application is a little smaller than normal, so that it
  181. fits
  182. onto the author's screen. But if you test the program with images it
  183. crashes!
  184.  
  185.  
  186. Bugs
  187. ====
  188.  
  189. - xdpyinfo outputs a wrong resolution
  190. - keyboard auto-repeat doesn't work
  191. - there's no colour support
  192. - clients don't recognize (properly) when the server dies
  193. - the cursor still flashes, even when X is running
  194. - the program-flags aren't set correctly, so the programs can't use
  195. fast-ram
  196.  
  197.  
  198. Author
  199. ======
  200.  
  201. Send comments and bug reports to
  202.  
  203.   Andreas Kirschbaum
  204.   ank@rbg.informatik.th-darmstadt.de
  205.  
  206. or via snail mail:
  207.  
  208.   Andreas Kirschbaum
  209.   Quellenstr. 5
  210.   61118 Bad Vilbel
  211.   Germany
  212.  
  213.  
  214. Tschuess, Michael
  215.  
  216.     ------------------------------------------------------------------------
  217.  
  218.  
  219.